راهنمای نصب و اجرای رستم اکسترکتور در macOS
================================================
نسخه: 2.1.0
معماری: Universal — سازگار با مک‌های Apple Silicon و Intel

این نسخه فقط امضای محلی ad-hoc دارد؛ با گواهی Developer ID امضا نشده
و تأیید notarization اپل را ندارد. هنگام اولین اجرا ممکن است macOS
هشدار امنیتی نمایش دهد. فقط نسخه‌ای را باز کنید که از منبع مورد اعتماد
دریافت کرده‌اید؛ در صورت انتشار SHA-256، هش فایل دانلودشده را مقایسه کنید.

── روش اول: کپی برنامه در Applications ──
۱. اگر فایل DMG را دریافت کرده‌اید، آن را باز کنید.
۲. برنامهٔ RostamExtractor.app را به پوشهٔ Applications کپی کنید.
   اگر پوشهٔ حاوی برنامه را دریافت کرده‌اید، برنامه را از همان پوشه کپی کنید.
۳. برنامه را باز کنید. اگر macOS مانع اجرا شد، مسیر زیر را بررسی کنید:
   System Settings → Privacy & Security → Open Anyway
   نمایش و محل این گزینه به نسخهٔ macOS و تنظیمات امنیتی دستگاه بستگی دارد.
   در بعضی نسخه‌ها راست‌کلیک روی برنامه و انتخاب Open نیز در دسترس است.
۴. پس از کپی برنامه، می‌توانید دیسک مجازی DMG را Eject کنید.

── روش دوم: استفاده از فایل اجرای کمکی ──
برنامه و فایل زیر را از داخل DMG به یک پوشهٔ قابل نوشتن، مانند پوشه‌ای
روی Desktop، کپی کنید و کنار هم نگه دارید:

  RostamExtractor.app
  Open-RostamExtractor.command

سپس روی فایل Open-RostamExtractor.command دوبار کلیک کنید.
این فایل، ویژگی‌های توسعه‌یافتهٔ برنامه از جمله quarantine را با دستور
xattr -cr حذف می‌کند و سپس برنامه را باز می‌کند. این کار معادل تأیید
امنیت برنامه توسط اپل یا امضای Developer ID نیست.
خود فایل command نیز ممکن است با محدودیت اجرای macOS روبه‌رو شود.
آن را مستقیماً از داخل DMG که فقط خواندنی است اجرا نکنید.

نام برنامه برای این روش باید دقیقاً RostamExtractor.app باشد.
اگر نام آن RostamExtractor .app است، فاصلهٔ قبل از .app را از نام
حذف کنید. در Finder ممکن است پسوند .app نمایش داده نشود؛ در آن حالت
نام نمایشی باید RostamExtractor باشد، بدون فاصلهٔ اضافی در انتها.
نام پوشه‌ها و فایل‌های داخل بستهٔ برنامه را تغییر ندهید.

── اگر همچنان باز نمی‌شود ──
اگر برنامه را در Applications کپی کرده‌اید و نام آن دقیقاً مطابق بالاست،
Terminal را باز کنید و دستور زیر را اجرا کنید:

  xattr -cr /Applications/RostamExtractor.app

سپس دوباره برنامه را باز کنید.
این دستور ویژگی‌های توسعه‌یافته از جمله نشان quarantine را حذف می‌کند؛
این تغییر، برنامه را notarized نمی‌کند و اعتبار ناشر را اثبات نمی‌کند.
برای مسیر یا نام دیگری، دستور بالا به همان شکل قابل استفاده نیست.

── شروع استخراج و اشتراک‌گذاری ──
۱. یک یا چند فایل ضبط با پسوند ts، trp، mts یا m2ts انتخاب کنید.
۲. پوشهٔ خروجی را انتخاب کنید و استخراج را شروع کنید.
۳. فایل‌های موجود بازنویسی نمی‌شوند؛ در صورت تداخل نام، خروجی جدید
   با نام شماره‌دار مانند _2 ذخیره می‌شود.
۴. در پایان، لغو یا شکست استخراج، برنامه تلاش می‌کند گزارش
   rostam-extraction-report.json را در پوشهٔ خروجی و نسخه‌ای از آن را
   در پوشهٔ لاگ ذخیره کند. اگر گزارش در دسترس نبود، از Open Logs استفاده کنید.
۵. برای اشتراک‌گذاری Wi-Fi، مک و گوشی باید به یک شبکهٔ محلی متصل باشند.

── دربارهٔ بستهٔ دانلود ──
DMG ظرف توزیع برنامه است. می‌توانید برنامه را در Applications یا پوشهٔ
قابل نوشتن دلخواه نگه دارید. ZIP برای اجرای برنامه الزامی نیست.
اجرای برنامه از پوشهٔ دلخواه به معنی ذخیره شدن تمام تنظیمات و لاگ‌ها
در همان پوشه نیست.

این راهنمای فارسی همراه پوشهٔ تحویل ارائه شده است؛ DMG موجود با افزودن
این فایل بازسازی نشده و نسخهٔ فارسی هنوز داخل آن قرار ندارد.
